
!!!READ SETUP GUIDE FIRST TO GET THINGS SETUP!!!


/**************** User Guide Edit Mode **************************************************/
EDITMODE - CREATING ANIMTOOLS POSITIONS

Run the copy of the animtools.swf file that was setup for 'editmode' from the setup guide. It is suggested to use the adobe standalone flash projector to do this.
Sdt will open up, and additional information will be displayed on the screen.
Use the buttons on the graphical user interface or the keymappings to create and edit position files, and then save them out as text files.
These text files can then be loaded when animtools is ran as a loader mod to provide custom positions.

/************************/
GRAPHICAL USER INTERFACE:

	UPPERLEFT CORNER BUTTONS:
		In the upperleft corner are the save, load, keys, reset, vars, and button page buttons:

			save:             save out the current animtools position. it saves as a text file.
			load:             open up a explorer box to choose an animtools position file to load.
			reset:            resets the current position to the default position.
			keys:             disables the animtools key mappings (the key mappings are used to create positions)
			[0]button page:   toggles between the two key mappings of animtools. pressing the '0' key will do the same
			vars:             resets the local variables animtools uses. if doing body contact stuff, this may be helpful to press after changing around him/her positions. should be pressed when he is not contacting her, which should be when 'pops' debug info is less than 0.


		
	UPPER MIDDLE:
		In the upper middle part of the screen is some debug information from the sdt game:

			 current body resistance: indicates current resistance for bodycontactresistance
			 body override:           debug flag for situations where penis stops contacting her through traveling through her (tit fucking situation)
			 penisinmouthdisttrack:   tracks the minimum position animation when her contact starts, used for bodycontact
			 her.pos:                 current her animation position, ranges from about -0.2 to 1.02
			 spacehelddist:           number used to provide "push through" for body contact resistance
		 	
		 
	RIGHT SIDEBAR:
		Has controls to adjust everything in animtools. they change depending on the buttonpage selected.
		Left arrows decrease values, right arrows increase vaues, 'x' resets value to default
		Can manually type in values you desire in the value display area. everything is a number and the input boxes only accept numbers. press enter to input that value after typing it.
		
		If the setting has a keyboard mapped key, will be labelled in brackets []
		Settings that are x,y coordinates use the mouse location to set the values when using the keyboard keys, use spacebar to select the point if not set upon pressing.
		
		Button page 1:
			positiontype: the type of sex the position pertains to. 0=oral, 1=tit, 2=vaginal, 3=anal, 4=other. affects how dialogs might treat the position and undoes some sdt movement limitations (non-oral position do not have 'intro' dialog)
			dominant: determines who is dominant person in the position, meant to act as something like a 'him holding' check for non-oral positions. only affects dialogs.
			maxpenissize: limits the size of the penis according to this value, some positions don't work well with two big of a penis. value is based on the penis's scale; 1.2 is the vanilla max and 0.7 is the vanilla min
			allow licking: determines if she does licking or not, mostly for non-oral positions
			
			screen reversed: if the screen should be mirrored or not, usually this is an in game personal preference
			[left arrow, right arrow] camera x: the position of the camera on the x axis
			[up arrow, down arrow] camera y: the position of the camera on the y axis
			[home,end] zoom amount: how close or far the camera is. zooming out farther than 0.4 will cause strands to no longer render
			[z] zoom point x: the target zoom point on the x axis, the camera will towards this for the built in sdt zoom feature
			[z] zoom point y: the target zoom point on the y axis, the camera will towards this for the built in sdt zoom feature
			[c,v] scene rotation: the rotation angle of the entire scene
			change strand/hair gravity: strands and hairs will 'fall' towards the bottom of the screen, no matter the scene rotation. does not affect their initial speed and direction
			angled gravity force: the force of gravity that is applied to strands that have their gravity changed
			
			his arm free: determines his arm position regarding holding or free
			him hidden: determines if he is hidden or not (his penis is the only thing that shows)
			him flipped: flips him vertically
			him reversed: flips him horizontally
			
			
			
			[5] his left foox x: the x coordinate location of his left foot 
			[5] his left foox y: the y coordinate location of his left foot 
			[6] his right foox x: the x coordinate location of his right foot 
			[6] his right foox y: the y coordinate location of his right foot 
			
			[7] her torso(knee) x: the x coordinate location of her knees(affects how her torso is placed)
			[7] her torso(knee) y: the y coordinate location of her knees(affects how her torso is placed)
			[l,;] right leg offset angle: adjust the angle where her legs mount to offset from her torso knee x,y. useful to shift her torso around while having a different leg angle
			[o,p] right calf end angle: adjust how much her knees bend (there are limitations)
			left leg offset angle: adjust the angle where her right leg mount to offset from her torso knee x,y. if not set uses right leg offset
			left calf end angle: adjust how much her left knee bend (there are limitations). if not set uses right calf angle
			
			[.] her leg behind him: puts her back leg behind him, for positions to make him look like he is between her legs 
			set penis out(behind her): makes his penis behind her, for non-oral positions
			set left breast behind: layers her left breast behind his penis
			hide her shadow: hides her calf floor shadows. for positions where her legs are off the ground
			
			her offpath movement: how much that vertical mouse mousement has her to sway from her linear positoning
			[1] her tween start x: x coordinate location of the start of her movement animation
			[1] her tween start y: y coordinate location of the start of her movement animation
			[2] her tween end x: x coordinate location of the end of her movement animation
			[2] her tween end y: y coordinate location of the end of her movement animation
			[a,s] her tween start angle: starting angle of her movement animation
			[d,f] her tween end angle: ending angle of her movement animation
			
			use steady penis: his penis will not bob around during movement
			penis rotation offset: an offset to his penis angle compared to his torso
			penis rotation offset end: the end angle for his penis to follow based on position. if not set uses the nomal offset anglee
			[3] his tween start x: x coordinate location of the start of his movement animation
			[3] his tween start y: y coordinate location of the start of his movement animation
			[4] his tween end x: x coordinate location of the end of his movement animation
			[4] his tween end y: y coordinate location of the end of his movement animation
			[q,w] his tween start angle: starting angle of his movement animation
			[e,r] his tween end angle: ending angle of his movement animation
						
			
			[t,y] torso min angle: the highest angle her neck will be during her movement, if unsure can crank this high (like 9) and use next 2 settings without worry
			[g,h] torso start angle: the starting reference angle of her movement. if you pull her back farther than 3/4's of the way, her angle can go below this reference angle
			[b,n] torso angle multiplier: how much her neck will rotate according to her movement (positive is a clockwise rotation)
			[u,i] torso min distance: the longest distance her neck will be to her torso during her movement, if unsure can crank this high (like 300) and use next 2 settings without worry
			[j,k] torso start distance: the starting reference distance between her neck and torso according to her movement. if you pull her back farther than 3/4's of the way, her distance can go below this reference distance.
			[m ,] torso distance multiplier: how much her neck will move according to her movement (positive is increased distance)
			
			
			
		Button page 2:
			DA her masterbate: upon position loading, attempts to tell the mod 'Dialog Actions' to use its her masterbating function
			
			allow right arm drop: when she passes out, allows her arm to fall
			allow right arm tapping: allows her to tap her hands (when running out of air and such)
			right arm position: changes her arm position. this menu now has the alternate hand positions as well as the 'don't care' option
			[q] right arm pos x: x coordinate location of her right arm. sets her arms in 'on legs' position
			[q] right arm pos y: y coordinate location of her right arm. sets her arms in 'on legs' position
			[a] right arm pos end x: ending x coordinate where her arm will be placed
			[a] right arm pos end x: ending y coordinate where her arm will be placed
			hand angle right: adjust the angle of her hand, sets her arm position to 'on legs'. the keyboard key uses the coordinates of the mouse.
			hand angle right end: the ending angle for her right hand
			use right hand closed: toggles the hand to the 'closed' sprite
			reverse right hand: turns her hand around
			rub hand right: turns on her hand rubbing
			
			allow left arm drop: when she passes out, allows her arm to fall
			allow left arm tapping: allows her to tap her hands (when running out of air and such)
			left arm position: changes her arm position. this menu now has the alternate hand positions as well as the 'don't care' option
			[w] left arm pos x: x coordinate location of her left arm. sets her arms in 'on legs' position
			[w] left arm pos y: y coordinate location of her left arm. sets her arms in 'on legs' position
			[s] left arm pos end x: ending x coordinate where her arm will be placed
			[s] left arm pos end x: ending y coordinate where her arm will be placed
			hand angle left: adjust the angle of her hand, sets her arm position to 'on legs'. the keyboard key uses the coordinates of the mouse.
			hand angle left end: the ending angle for her left hand
			use left hand closed: toggles the hand to the 'closed' sprite
			reverse left hand: turns her hand around
			rub hand left: turns on her hand rubbing

			enable custom his arm: allows animtools to control his holding arm movement
			[3] his shoulder point start x: x coordinate of where his shoulder is presummed to be at the start of moving
			[3] his shoulder point start y: y coordinate of where his shoulder is presummed to be at the start of moving
			[4] his shoulder point end x: x coordinate of where his shoulder is presummed to be at the end of moving
			[4] his shoulder point end y: y coordinate of where his shoulder is presummed to be at the end of moving
			[5] his arm rest point x: x coordinate of where his arm goes when is not holding her
			[5] his arm rest point y: y coordinate of where his arm goes when is not holding her
			[6] his arm start point x: x coordiante of where his arm is at the start of his movement
			[6] his arm start point y: y coordiante of where his arm is at the start of his movement
			[7] his arm end point x: x coordiante of where his arm is at the end of his movement
			[7] his arm end point y: y coordiante of where his arm is at the end of his movement
			
			alternate arm follows: his loader placed other arm will follow the positioning 
			[t] his alt arm rest point x: x coordinate of where his arm goes when is not holding her
			[t] his alt arm rest point y: y coordinate of where his arm goes when is not holding her
			[y] his alt arm start point x: x coordiante of where his arm is at the start of his movement
			[y] his alt arm start point y: y coordiante of where his arm is at the start of his movement
			[u] his alt arm end point x: x coordiante of where his arm is at the end of his movement
			[u] his alt arm end point y: y coordiante of where his arm is at the end of his movement
			
			
		Button page 3:
			[q,w,e,r,t,y,u,i,o,p] currentprop: selects a specific prop to be manipulated with the other prop keys. pressing the key again while it is selected will toggle the prop off
			reset prop / reset all: clicking left or right arrows will reset current prop, clicking 'X' will reset all props
			
			[q,w,e,r,t,y,u,i,o,p] prop visible: makes the prop visible. the keyboard keys will toggle their visibility if they are the current prop editing
			
			[z to set; a,s] current prop x: the x coordinate location of the current prop
			[z to set; d,f] current prop y: the y coordinate location of the current prop
			
			[h flip; v,b] current prop scale x: the scale of a prop horizontally
			[g flip; n,m] current prop scale y: the scale of a prop vertically
			
			[x,c] rotate current prop: rotates the current prop

	   -----------------		
			*note, the rest of these are rewritten by the sexual experience presets*
			
			undo vanilla move vigour: undoes the vigour increases from the normal vanilla movement
			undo all vanilla vigour: only permits vigour increases from animtools resistive vigour
			
			body contact vigour: enables changing vigour with body contact
			body contact vigour speed: how much the speed of her movement contributes to body contact vigour
			body contact vigour constant: how much is constantly added to vigour while in body contact
			
			body contact sounds: enables sound effects when entering and leaving her body contact
			body contact sounds in speed: minimum speed required to activate the 'in' sound of body contact sounds
			body contact sounds out speed: minimum negative speed required to activate 'out' sound of body contact
			
			hide strands in body contact: will hide strands that are ejaculated while in body contact with her
			adjust speed in body contact: her speed will slow down while in body contact
			space holds body contact: her body contact resistance will not reset out of her body contact if space is held
			penisrange body contact mask: allows using the mask from the penisrange mod (if it is loaded) for body contact
			pleasure from body contact: he will gain pleasure from body contact with her
			pleasure from contact mult: adjust how much pleasure he is given from her movement while in body contact
			
			resistance with body contact: allows having a restrictive force from body contact similar to SDT intro for oral positions
			resistance starting distance: the distance after contact that resistance starts
			starting resistance: her starting resistance, higher = more resistive
			min resistance: the lowest amount resistance is allowed to achieve. (resistance starts high, and slowly decreases as she becomes 'loose')

			resistance decrease rate: how quickly her resistance is decreased statically
			resist reset(increase) rate: the rate that resistance returns to startingresistance when not bodycontacting her
			movement resistance mult: multiplier of how quickly her resistance is lowered by movement

			resist override rate: how quickly the override resistance allows movement forward
			resist override return rate: how quickly the override resistance is undone
			resist override max: the max penisinmouthdist (animation distance) override allowed to go to

			resistive vigour enabled: enable vigour changes through bodycontactresistance
			resistive vigour mult: multiplier of how much vigour is increased when her resistance is lowered
			resistive vigour speed mult: multiplier of how much vigour is increased according to position movement speed
			constant resistive vigour mult: multiplier of how much vigour is increased according to current resistive value
			resistive vigour space mult: multiplier of how much vigour is increased when the spacebar is pressed to force through resistance

			
			
			
/*******************************/		
PARTIAL ANIMTOOLS POSITION FILES:

It is possible to create special animtools positions that are tagged as being 'partial' that only change certain position settings.
To do this, open a position file in a text editor and delete the desired settings you don't want changed. then add the tag '_partial' to the end of the name of the position.
	example~ 	a position is called 'hidehim.txt' 
				This file is opened and everything but the setting to hide him is removed. 
				The file is then renamed to 'hidehim_partial.txt'
				Now the position only hides him, while keeping the previous position the same.

This requires the 'alwaysresetmissingsettings' option to be off (default is off, see anomtoolsV8settings.txt)



/*****************************/
UPDATING OLD ANIMTOOLS POSITION FILES:

Newer animtools position files contain more settings to enable additional features. These position settings may be pasted into the position text file directly through a text editor, or the position can be loaded into animtools in loadermode and then change and save the file. 
If a position is not oral sex based, the position should be updated with the proper 'positiontype' value set


